home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / HL100.ZIP / HIGHNLOW.DOC < prev    next >
Encoding:
Text File  |  1996-03-27  |  20.2 KB  |  479 lines

  1.    --------------------------------------------------------------------
  2.  
  3.                 -= High N' Low =-
  4.  
  5.                   Version  1.00
  6.  
  7.              Online Door Game For BBSs
  8.  
  9.                Games Unlimited (tm) Software
  10.             Copyright (c) 1996 by Michael Kinser
  11.                 All Rights Reserved
  12.  
  13.  
  14.    Table Of Contents
  15.    -----------------
  16.  
  17.    Introduction................................................... 1
  18.    Copyright/Warranty/Agreement................................... 2
  19.    Setup.......................................................... 3
  20.    Game Play...................................................... 4
  21.    Sysop Instructions............................................. 5
  22.    Trouble Shooting............................................... 6
  23.    Registration................................................... 7
  24.    Defining Custom Door Information Files......................... 8
  25.    Possible Future Enhancements................................... 9
  26.    Special Thanks................................................ 10
  27.  
  28.  
  29.    --------------------------------------------------------------------
  30.    1. INTRODUCTION
  31.    ---------------
  32.  
  33.       High N' Low is a online door game for Bulletin Board Systems.
  34.    However it may also be used without a BBS.  High N' Low features:
  35.  
  36.        Multi-Node Support
  37.        Great ANSI Graphics
  38.        Full Split Screen Chat
  39.        Game completely resets at the beginning of each
  40.      month meaning no sysop maintenance!
  41.        Monthly Hall Of Fame
  42.        Last Year Hall Of Fame
  43.        Easy Setup
  44.        and much much more...
  45.  
  46.    --------------------------------------------------------------------
  47.    2. COPYRIGHT/WARRANTY/AGREEMENT
  48.    -------------------------------
  49.  
  50.       High N' Low is copyrighted software which is distributed under the
  51.    shareware concept.  Under this license agreement you are granted the
  52.    right to use High N' Low on all machines and environments that it
  53.    supports for a resonable trial period without registering.  If you
  54.    decide to keep this software and/or use this software after the trial
  55.    period, you must register or you will be in violation of United
  56.    States and International copyright laws.
  57.  
  58.       As a Shareware Program, High N' Low may be freely distributed
  59.    through Bulletin Board Systems, computer networks, on floppy disks,
  60.    and on CDs or other magnetic media.  Never give a copy of the
  61.    HIGHNLOW.KEY file to anyone as this is a violation of the United
  62.    States and International copyright laws.  You may pass copies of the
  63.    Unregistered version to others as long as it is not for payment or
  64.    bundled with anything else that is for payment, and you distribute
  65.    all original files without any changes.  This includes the
  66.    Configuration files.  All file dates should to set to one date and
  67.    the file times should be set to the version number of the program if
  68.    it is directly from me.  A small fee may be charged for the media
  69.    High N' Low is distributed on. 
  70.  
  71.       High N' Low, and all releated materials, is distributed without
  72.    warranty.  In no event will we be liable to you for damages,
  73.    including any loss of profits, lost savings, or other incidental or
  74.    consequential damages arising out of your use of or inability to use
  75.    the program, even if we have been advised of the possibility of such 
  76.    damages.  We will not be liable for any such claim by any other
  77.    party.
  78.  
  79.       It is a violation of the High N' Low agreement to modify the EXE
  80.    files in any way.
  81.  
  82.       You acknowledge that you have read this agreement, that you
  83.    understand this agreement, and understand that by continuing the
  84.    installation of the software, by loading or running the software, or
  85.    by placing or copying the software onto your computer hard drive or
  86.    memory, you agree to be bound by this agreement's terms and
  87.    conditions.
  88.  
  89.    --------------------------------------------------------------------
  90.    3. SETUP
  91.    --------
  92.  
  93.      1.  Make a directory, for example C:\HIGHNLOW, and copy all of the
  94.      files into this directory.
  95.      2.  Run the HLCFG.EXE program.  Example:  HLCFG HIGHNLOW.CFG
  96.      You may name the configuration file whatever you choose.
  97.      HLCFG.EXE will create an example batch file which you MUST
  98.      use.
  99.      3.  Set up High N' Low in your BBS door menu and optionally your
  100.      door bulletin menu.  Use the sample batch file that HLCFG
  101.      created.  You will have to edit it to run your BBS after the
  102.      game and be sure that it changes to the correct directory to
  103.      run the game
  104.       
  105.       Please Note:  You may also specify the name of the door information
  106.    file at the end of the BBS Directory in HLCFG.EXE.  For example, for
  107.    the BBS Directory, you may enter "C:\BBS" or you can enter
  108.    "C:\BBS\DOOR.SYS".  For multi-node setups, you must use the HLCFG to
  109.    set up a batch file for every node.
  110.       If you configure High N' Low in one directory and then decide you
  111.    want it in another directory, you will have to edit the batch file to
  112.    reflect the changes.
  113.       For non-standard Com Ports, you must edit the batch file and change
  114.    the the IRQ settings.  More options are available through the usage of
  115.    a batch file.  Type HIGHNLOW /? at the DOS Prompt for more
  116.    information.
  117.    
  118.       High N' Low supports DOOR.SYS, DORINFO?.DAT, EXITINFO.BBS, 
  119.   CHAIN.TXT, CALLINFO.BBS, SFDOORS.DAT, and Custom Door Information
  120.   files (see DEFINING CUSTOM DOOR INFORMATION FILES) defined in the
  121.   config file.  A sample DORINFO1.DEF file has been included.
  122.   High N' Low should be compatible under DOS, DESQview, Windows, and
  123.   OS/2.
  124.       High N' Low may be run locally (without a Bulletin Board System)
  125.   by typing LOCAL from the DOS prompt.
  126.       If you have registered High N' Low, you may also make an ANSI file
  127.   named REGISTER.ANS with the names of the people who registered the game
  128.   in it.  This will be shown before the game returns control back to the
  129.   BBS.
  130.       Please Note:  If you have defined a Custom Door Information File in
  131.   the configuration file, do not use that configuration file with the
  132.   HLCFG.EXE.  It will not read the Custom Door Information File section
  133.   or save it!
  134.  
  135.   ---------------------------------------------------------------------
  136.   4. GAME PLAY
  137.   ------------
  138.  
  139.       Game play is simple.  A player bets money and tries to guess if the
  140.    next die will be higher or lower.  Scores are kept throughout the
  141.    month/year.  Each player is given a certain amount of games per day.
  142.    The player may press H for help during game play.  The player will also
  143.    have other options during game play such as pressing the A key will bet
  144.    all of their money and press <Enter> will repeat the last bet.  All
  145.    options available to the player are in the help screens.
  146.       On the "one before the last" bet, the user must enter at least 1/4
  147.    of the money they have.  On the last bet, the user must enter at least
  148.    1/2 of the money they have.  A bonus on $500,000 is added to the
  149.    players score if he/she gets all bets during a game correct!
  150.       Games Per Day are automatically added up.  For example, if a user
  151.    enters High N' Low on the 4th day of the month and you have
  152.    Games Per Day set at 5, the user will automatically have 20 games left.
  153.  
  154.    --------------------------------------------------------------------
  155.    5. SYSOP INSTRUCTIONS
  156.    ---------------------
  157.  
  158.       High N' Low gives the Sysop the control they need to interact with
  159.    users.  The following functions are available to the Sysop while a user
  160.    is in the door.
  161.  
  162.    KEY               FUNCTION
  163.    ------------      --------------------------------------------------
  164.  
  165.    [UP]/[DOWN]       Use the arrow keys to increase or decrease the
  166.              amount of time which the user has left in the door.
  167.  
  168.    [Alt]-[C]         Allows the sysop to break into chat with the user.
  169.              Pressing [ESC] will end chat mode.
  170.  
  171.    [Alt]-[J]         Allows the sysop to shell to DOS, if enough memory
  172.              is available.  Simply type EXIT to return to the
  173.              door again.
  174.  
  175.    [Alt]-[H]         Hang up on the user.
  176.  
  177.    [Alt]-[L]         This key locks the user out of the BBS.  It first
  178.              hangs up on the user, and then sets their security
  179.              level to 0, to prevent them from logging on again.
  180.              This feature may require use of the EXITINFO.BBS
  181.              file, depending on what system the door is running
  182.              under.
  183.  
  184.    [Alt]-[K]         The "User Keyboard-Off" key allows the sysop to
  185.              temporarily prevent the user from typing anything on
  186.              their keyboard.  This has no effect on the local
  187.              keyboard.
  188.  
  189.    [Alt]-[N]         The "Sysop Next" key, this function reserves the
  190.              system for use by the sysop after the user logs off,
  191.              if the door is running under an Apex or RA 1.00 or
  192.              later system.
  193.  
  194.    [Alt]-[D]         "Drop to BBS" key.  This function allows the sysop
  195.              to exit the door and return the user to the BBS,
  196.              without hanging up.
  197.  
  198.    --------------------------------------------------------------------
  199.    6. TROUBLESHOOTING
  200.    ------------------
  201.  
  202.    1. When I try to run High N' Low locally from DOS, it says that it
  203.       cannot read the door information file.  What is wrong?
  204.  
  205.       The last door information files that your BBS created were for
  206.       someone that was online.  Log on to your BBS locally and then try
  207.       again, or run High N' Low locally by typing LOCAL at the DOS prompt.
  208.  
  209.  
  210.    2. When someone enters the door, all they receive is garbage.  What
  211.       should I do?
  212.  
  213.       Be sure you have set your "Locked BPS" and "COM Port" correctly in
  214.       the batch file.  HLCFG.EXE will allow you to do this.
  215.  
  216.  
  217.    3. When I run the game, it gives me a file error.  What am I doing
  218.       wrong?
  219.  
  220.       When you run the game, you must first change to the directory where
  221.       all of the High N' Low data files reside.  If you are doing that
  222.       correctly, then you should make sure that you have all files that
  223.       was included in the original ZIP file.  If it is an original copy
  224.       from me, it will have 8 files, all with the same file dates, and
  225.       the file times will the same as the version number.
  226.  
  227.  
  228.    4. When I quit, I get an file error.  What is wrong?
  229.  
  230.       You need to set the ANSI and ASCII bulletin options in the
  231.       configuration program to VALID filenames or no filenames at all,
  232.       including no spaces at all.
  233.  
  234.  
  235.    5. Jump To DOS (Alt-J) does not work.
  236.  
  237.       If you press the Alt-J function key, but do not get any results,
  238.       your problem is likely as a result of lack of memory.
  239.  
  240.  
  241.    6. The game just won't work.
  242.  
  243.       Check your batch file and be sure it is changing to the correct
  244.       directory where the High N' Low files reside first.  Also be sure
  245.       that you have set up your COM Port and your Locked BPS in the batch
  246.       file.
  247.  
  248.  
  249.    7. I have a problem that I cannot figure out, even after I read this
  250.       document.  What should I do?
  251.  
  252.       You should write me about your problem.  Please explain the problem
  253.       in full detail or I cannot help you.  Also, it would be helpful if
  254.       you could explain how I can duplicate the problem on my computer.
  255.  
  256.              Michael Kinser
  257.              Games Unlimited Software
  258.              P.O. Box 804
  259.              Norton, VA 24273
  260.  
  261.       I may have the Games Unlimited (tm) BBS up and running soon and
  262.    support will be provided by it also.  TriBBS #3000.
  263.  
  264.    --------------------------------------------------------------------
  265.    7. REGISTRATION
  266.    ---------------
  267.  
  268.       High N' Low is not crippled in any way.  The Unregistered version
  269.    functions exactly like the Registered version except for a few
  270.    "Reminders" and the Games Per Day limit.
  271.       Until High N' Low is Registered, it is limited to 2 Games Per Day,
  272.    has a small Unregistered Delay, says Unregistered on the Title screen,
  273.    Score screens, Bulletins, and the Configuration Module.  These small
  274.    "Reminders" will be removed after you register and you will be able
  275.    set it up to allow more games per day (maximum of 40).  I recommend 5
  276.    to 10 games a day.  You may also make an ANSI file named REGISTER.ANS
  277.    with the names of the people who registered the game in it.  This will
  278.    be shown before the game returns control back to the BBS.  Be sure to
  279.    write "Press Any Key To Continue..." or something to that effect in
  280.    the REGISTER.ANS if you use one.
  281.  
  282.       High N' Low is copyrighted software which is distributed under the
  283.    shareware concept.  Under this license agreement you are granted the
  284.    right to use High N' Low on all machines and environments that
  285.    supports it for a resonable trial period without registering.  If you
  286.    decide to keep this software and/or use this software after a
  287.    resonable trial period, you must register.
  288.  
  289.       Please print REGISTER.TXT, fill it out, and send it along with
  290.    $10.00 + $2.00 Shipping & Handling (Check or Money Order Payable to
  291.    Michael Kinser) to:
  292.  
  293.              Michael Kinser
  294.              Games Unlimited Software
  295.              P.O. Box 804
  296.              Norton, VA 24273
  297.  
  298.       If you do not have a printer, you may write all of the information
  299.    down from REGISTER.TXT and fill it out.
  300.       Once you register, you will be registered for all future versions.
  301.    All upgrades will be free.  It will be up to you to download the
  302.    upgrades.
  303.       Once you register, I will send you a "KEY" file.  Just copy this
  304.    file into the same directory where the High N' Low files reside, and
  305.    the next time it is run, it will say Registered.  DO NOT GIVE ANYONE
  306.    A COPY OF YOUR KEY FILE.  This will be your registered "KEY" only with
  307.    YOUR name inside of it!  High N' Low "KEY" files may NOT be
  308.    transfered, for example, if your BBS closes down, you may not give
  309.    someone the "KEY" file.
  310.  
  311.    --------------------------------------------------------------------
  312.    8. DEFINING CUSTOM DOOR INFORMATION FILES
  313.    -----------------------------------------
  314.  
  315.       Please note, if you have defined a Custom Door Information File in
  316.    the configuration file, do not use that configuration file with
  317.    HLCFG.EXE!  The configuration files may be edited with a normal ASCII
  318.    text editor such as MS-DOS EDIT.
  319.  
  320.       High N' Low allows you to define a custom door information file
  321.    format in the config file.  This permits High N' Low to operate
  322.    directly on any BBS system that produces a door information file
  323.    format not directly supported by High N' Low.  A custom door
  324.    information file format is defined using the "CustomFileName" option,
  325.    followed by one or more lines beginning with the "CustomFileLine"
  326.    option.
  327.  
  328.       The "CustomFileName" option specifies the filename used to
  329.    distinguish this file format from other file formats.  This filename
  330.    should not include a path.  If the filename of the custom format is
  331.    the same as that of one of the built-in formats, the custom format
  332.    will override the built-in format.
  333.  
  334.       The actual format of the custom file is specified using a number of
  335.    lines that begin with the keyword "CustomFileLine".  Each of these
  336.    lines will correspond to a single line in the door information file,
  337.    with the option following the "CustomFileLine" keyword specifying the
  338.    information that can be found on that line.  This can be one of the
  339.    following keywords:
  340.  
  341.  
  342.    Ignore - Causes the next line in the door information file to be
  343.         ignored. Use on lines for which none of the options below
  344.         apply.
  345.  
  346.    COMPORT - COM? port the modem is connected to (0 indicates local mode)
  347.  
  348.    FOSSILPORT - Fossil port number the modem is connected to
  349.  
  350.    MODEMBPS - BPS rate at which to communicate with modem (0 or non-
  351.           numerical value indicates local mode)
  352.  
  353.    LOCALMODE - 1, T or Y if door is operating in local mode
  354.  
  355.    USERNAME - Full name of the user
  356.  
  357.    USERFIRSTNAME - First name(s) of the user
  358.  
  359.    USERLASTNAME - Last name of the user
  360.  
  361.    ALIAS - The user's pseudonym / handle
  362.  
  363.    HOURSLEFT - Hours user has left online
  364.  
  365.    MINUTESLEFT - Minutes user has left online, or time left online in
  366.          format hh:mm
  367.  
  368.    SECONDSLEFT - Seconds user has left online, or time left online in
  369.          format hh:mm:ss or format mm:ss (If more than one of the
  370.          above time options are used, the user time left is taken
  371.          to be the total of all of these values.)
  372.  
  373.    ANSI - 1, T, Y or G for ANSI graphics mode
  374.  
  375.    AVATAR - 1, T or Y for AVATAR graphics mode
  376.  
  377.    PAGEPAUSING - 1, T or Y if user wishes a pause at end of screen
  378.  
  379.    SCREENLENGTH - Number of lines on user's screen
  380.  
  381.    SCREENCLEARING - 1, T or Y if screen clearing mode is on
  382.  
  383.    SECURITY - The user's security level / access level
  384.  
  385.    CITY - City the user is calling from
  386.  
  387.    NODE - Node number user is connected to
  388.  
  389.    SYSOPNAME - Full name of the sysop
  390.  
  391.    SYSOPFIRSTNAME - The sysop's first name(s)
  392.  
  393.    SYSOPLASTNAME - The sysop's last name
  394.  
  395.    SYSTEMNAME - Name of the BBS
  396.  
  397.        As an example of how to define custom door information file
  398.    formats, consider the following imaginary file format, which we will
  399.    name DROPFILE.DAT:
  400.  
  401.            Michael Kinser      <-- User name
  402.            0                   <-- Local mode
  403.            COM1:               <-- Serial port to use
  404.            9600                <-- BPS rate
  405.            22:30:15 05-08-95   <-- File creation time
  406.            35                  <-- Time remaining (in minutes)
  407.            1                   <-- ANSI mode
  408.            Norton, Virginia    <-- Location
  409.  
  410.        This format would be defined in the configuration file as follows:
  411.  
  412.            CustomFileName DROPFILE.DAT
  413.            CustomFileLine USERNAME
  414.            CustomFileLine LOCALMODE
  415.            CustomFileLine COMPORT
  416.            CustomFileLine MODEMBPS
  417.            CustomFileLine IGNORE
  418.            CustomFileLine MINUTESLEFT
  419.            CustomFileLine ANSI
  420.            CustomFileLine CITY
  421.  
  422.       Notice that the first "CustomFileLine" keyword in the configuration
  423.    file corresponds to the first line in our DROPFILE.DAT file, the
  424.    second "CustomFileLine" to the second line, and so on. Also notice
  425.    that the keyword "IGNORE" is used for the line that contains the file
  426.    creation time, since there is no CustomFileLine keyword that allows
  427.    you to read this information.
  428.  
  429.    --------------------------------------------------------------------
  430.    9. POSSIBLE FUTURE ENHANCEMENTS
  431.    -------------------------------
  432.  
  433.       I cannot be certain of any of the following.  Some, none, or all of
  434.    these enhancements may be added to High N' Low.
  435.  
  436.       1. ASCII Support
  437.       2. RIPscrip Support
  438.       3. RIPscrip Support on the Local Screen
  439.  
  440.    --------------------------------------------------------------------
  441.    10. SPECIAL THANKS
  442.    ------------------
  443.  
  444.       High N' Low would not be available if not for the great Beta
  445.    Testing of the following people:
  446.  
  447.    David Allio        Thanks for all of the suggestions and extensive
  448.      (SYSOP)           Beta testing!
  449.    Bryan Bates        You didn't want to test it, you just wanted to play
  450.                it!
  451.    Tim Bowman         Thanks for the help in programming it! (A little!)
  452.    Kevin Donelson     Thanks for Beta Testing, and letting me call your
  453.      (SYSOP)           board every day (early morning about 4 or 5) for
  454.                the past 3 or so years!
  455.    Sandra Kinser      Thanks for the help with all of the problems Mom,
  456.                and putting up with me!  Sorry about blowing up the
  457.                car...
  458.    Douglas Strouth    Thanks for all of the suggestions and extensive
  459.      (SYSOP)           Beta Testing!
  460.  
  461.       Everyone spent a great deal of time to help me get this game going
  462.    how I wanted it to.  Thanks everyone!  I hope I didn't leave anyone
  463.    out.
  464.  
  465.    Games Unlimited is a trademark of Games Unlimited Software and the
  466.      Games Unlimited BBS.
  467.    OS/2 is a registered trademark of IBM Corporation.
  468.    RIPterm and RIPscrip are trademarks of TeleGraphix Communications, Inc.
  469.    Windows is a registered trademark of Microsoft Corporation.
  470.    MS-DOS is a registered trademark of Microsoft Corporation.
  471.    All other programs are copyright and/or trademarked by their
  472.      respective author unless otherwise noted.
  473.  
  474.    This is the first door of many to come from Games Unlimited (tm)
  475.    Software.  Any feedback, good or bad comments, and suggestions are
  476.    welcomed.  Look for other doors by Michael Kinser coming soon!
  477.  
  478.    --------------------------------------------------------------------
  479.